Favicon

You are here: Home > API Reference > UEM > Device Audiences > Get device audience by ID

Get device audience by ID

Required Permission: mdm.global.deviceAudience.get

Get device audience by ID

GET
https://api.applivery.io/v1/organizations/{organizationId}/mdm/device-audiences/{deviceAudienceId} 
curl -X GET "https://api.applivery.io/v1/organizations/{organizationId}/mdm/device-audiences/{deviceAudienceId}" \
  -H "Authorization: Bearer <YOUR_API_KEY>"
const response = await fetch("https://api.applivery.io/v1/organizations/{organizationId}/mdm/device-audiences/{deviceAudienceId}", {
  method: "GET",
  headers: {
    Authorization: "Bearer <YOUR_API_KEY>",
  },
});

const data = await response.json();
import requests

response = requests.get(
    "https://api.applivery.io/v1/organizations/{organizationId}/mdm/device-audiences/{deviceAudienceId}",
    headers={"Authorization": "Bearer <YOUR_API_KEY>"},
)

data = response.json()

Request

Send your API key in the request header authorization
Example: Authorization: Bearer <token>

organizationId string
required
Match pattern: ^(([a-fA-F0-9]{24})|([a-zA-Z0-9\\-]{3,}))$
deviceAudienceId string
required
Match pattern: ^[a-fA-F0-9]{24}$

Responses

200 Response application/json
status boolean required
data object required
id string required
Match pattern: ^[a-fA-F0-9]{24}$
name string required
≤ 256 characters
description string optional
≤ 256 characters
createdAt string optional
updatedAt string optional
selectors object required
deviceGroups array [array] required
mdmUserGroups array [array] required
emmDeviceIds array [string] required
admDeviceIds array [string] required
winDeviceIds array [string] required
aosDeviceIds array [string] optional
mdmUserIds array [string] required
serialNumbers array [string] required
smartAttributes array [object] optional
segmentId integer optional
≥ 0 · ≤ 9007199254740991
{
    "status": true,
    "data": {
        "id": "string",
        "name": "string",
        "description": "string",
        "createdAt": "string",
        "updatedAt": "string",
        "selectors": {
            "deviceGroups": [
                [
                    "string"
                ]
            ],
            "mdmUserGroups": [
                [
                    "string"
                ]
            ],
            "emmDeviceIds": [
                "string"
            ],
            "admDeviceIds": [
                "string"
            ],
            "winDeviceIds": [
                "string"
            ],
            "aosDeviceIds": [
                "string"
            ],
            "mdmUserIds": [
                "string"
            ],
            "serialNumbers": [
                "string"
            ],
            "smartAttributes": [
                {
                    "id": "string",
                    "operator": "equal",
                    "value": "string"
                }
            ]
        },
        "segmentId": 0
    }
}
401 Response application/json
status boolean optional
false
error object optional
code number optional
4004
message string optional
Invalid Token
{
    "status": false,
    "error": {
        "code": 4002,
        "message": "No auth token"
    }
}
404 Response application/json
status boolean optional
false
error object optional
code number optional
3001
message string optional
Entity not found
{
    "status": false,
    "error": {
        "code": 3001,
        "message": "Entity not found"
    }
}